Magnum One/Magnum One (Mid-American Digital) (Disc Manufacturing).iso/d7/fetch10.arc/FETCH.DOC

Text File | 1991-07-30 | 5.7 KB | 119 lines

                 FETCH! Version 1.1    March 19, 1991
            Copyright 1991 David A. Rogers - Rascal Software


WHAT IS FETCH!?
Fetch is a file tagging program to be  used in conjunction with Telix or
other communications program. Fetch allows you to make an electronic
list of files that you wish to download from a bbs.  You can then have
Fetch! submit those names to the BBS to have them sent to you.  You can
then avoid making a paper list of files that interest you.  While there
are other programs that fulfill the same function, the ones I have seen
are all TSR's.  No matter how well written, I distrust TSR's and felt
the a non-TSR file picker would be a good thing to have.  --- And more
good news --- While Fetch! is NOT public domain and you may NOT sell
Fetch!, you may use Fetch! for your own purposes absolutely free!  One
thing I ask - send me a picture postcard of some local sight.

DISCLAIMER
Being the cautious sort, I suppose I need to say that you must use
Fetch! at your own risk.  I have done the best I can to make Fetch! rock
solid, but if someone manages to lose a file or something using Fetch! I
will not be held responsible.

REQUIREMENTS FOR FETCH!
Fetch! should work with almost any configuration of machine with the
proper command line parameters.  Fetch was written with the Telix
communication program in mind, but should work with any communication
PROGRAM whose command language allows you to read a file and to run a
program without clearing it's screen.

INSTALLATION
Put fetch.exe and the fetch.slc macro file in your Telix directory. You
do not need to keep the fetch.slt script source file unless you need to
modify it.  Use the ALT-K command in Telix to attach a keystroke to the
macro. (Telix.doc will tell you how).

GENERAL DESCRIPTION
Fetch! has two modes - Pick & Edit.  Pick mode allows you to pick
filenames off the screen and put them in the Fetch!'s file list.  Edit
mode allows you to tag files for download, delete files from the list,
and send the tagged filenames to the BBS for downloading.

USING FETCH!
Every BBS that has files available for downloading, has a method of
listing the available files.  Once you have listed a file on the screen,
you can invoke Fetch! by pressing the keystroke you defined in the
installation procedure above.  You have now temporarily exited Telix and
are in Fetch!  You will see a highlighted area in the upper left corner
of your screen.  This is the pick window.  Use the arrow keys to move
the window so that it covers the filename you want to add to your
download list.  Make sure that only the filename is covered by the pick
window.  Press enter to add that name to the list.  You can add up to 20
names to Fetch!'s download list.  Pressing the Escape key will return
you to Telix.  Or, once you have added one or more names to the fetch
list, you can look at the list in Edit mode.  Press e to enter the edit
mode.

In Edit mode, you will see the list of files you have selected in a box
in the top middle of your screen.  You can now tag the highlighted file
for downloading by pressing the space bar.  Pressing the space bar again
will untag the highlighted file.  You can change the highlighted file by
pressing the up/down arrows.  Pressing t tags all the files.  Pressing u
untags all the files.  Pressing d deletes the highlighted file from the
list.  Pressing enter will send the tagged filenames to the BBS, but
don't do that yet.  First exit Fetch! by pressing the Escape key.  You
can now talk to the BBS again.

Tell the bbs you want to download files.  When it asks you for the names
of the files you want to download, press either the carriage return key
or the the s key.  Some BBS's want you to enter a carriage return after
each file name.  In this case, you should press the Enter key.  Fetch!
will send the names of the tagged files separated by carriage returns.
Other BBS's want you to enter multiple filenames separated by spaces.
In this case, you should press the s key.  Fetch! will send the
filenames separated by spaces.  If you can only request one file at a
time (such as when using the Xmodem protocol) you should only tag one
filename and then use the s key to send that name only to the BBS. In
both Pick and Edit mode, pressing h will show a help box with the
pertinent key actions.

ADDITIONAL INFORMATION
The Fetch! command line looks like this:

fetch filename [bios] [edit]

filename is the file where Fetch! will store the file list.  If you like
playing with the Telix macros, you can modify the macro to keep a
separate file list for each BBS you call.

Fetch! does direct screen writes by default.  If you want Fetch! to use
bios writes, you must change the SALT scripts to add the keyword bios
(without the brackets) to the Fetch! command line.  Don't forget to
recompile once you have made this change.

Fetch! normally starts in Pick mode.  If you want Fetch! to start in
Edit mode, you can add the keyword edit to the command line.

Fetch! writes the file list to a file named select.lst which is then
read by the script and sent to the BBS.  If you have a terminal program
other than Telix, you may be able to set up macros so that Fetch! will
work for you.  Your comm program must be able to invoke a dos program
without clearing the screen so that Fetch! can read the filenames off
the screen.  It also must be able to read files so that it can send the
file created by Fetch! to the BBS.

If you have questions, comments, additional features you'd like to see
in Fetch! (or you want to send me that postcard - hint! hint!) -

David A. Rogers
4117 243rd Avenue S.E.
Issaquah, WA 98027


You can also reach me at the Cougar Mountain BBS (206)-391-1425
I also regularly attend the Intelec shareware echo.